home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / dev / gui / triton10.readme < prev   
Encoding:
Text File  |  1994-06-28  |  12.3 KB  |  281 lines
  1. Short: The object oriented GUI creation system.
  2. Author: stefan@wwsp.adsp.sub.org
  3. Uploader: mbars@bluejay.creighton.edu
  4.  
  5. Long:
  6.                 **********************************************
  7.  
  8.                     triton.library
  9.  
  10.                     The object oriented GUI creation system.
  11.  
  12.                     Release 1.0
  13.  
  14.                     (c) 1993-1994 Stefan Zeiger
  15.  
  16.                 **********************************************
  17.  
  18.  
  19.     Be sure to read the file 'Distribution', too!
  20.  
  21.     If you have suggestions or remarks about Triton, or if you find
  22. any bugs, please let me know.
  23.  
  24.     Contacting the author:
  25.  
  26.         EMail:      stefan@wwsp.adsp.sub.org
  27.  
  28.         Z-Netz:     stefan@sweet.zer
  29.                     stefan@plus.zer
  30.  
  31.         FidoNet:    Stefan Zeiger 2:244/6302.15
  32.  
  33.         Mail:       Stefan Zeiger
  34.                     Seligenstädter Weg 24
  35.                     D-63796 Kahl
  36.                     Germany
  37.  
  38.         Voice:      +49-6188-2525 (after 6:00 PM GMT only!)
  39.  
  40.     Please use EMail/Z-Netz/FidoNet if possible. This is more convenient for
  41. me and your chance of getting a reply quickly is much better.
  42.  
  43.  
  44. Contents
  45. ========
  46.  
  47. 1. Introduction
  48.  
  49. 2. Installation
  50.  
  51. 3. Using triton.library
  52.  
  53. 4. Astronomy Lesson
  54.  
  55. 5. Library history
  56.  
  57. 6. Credits
  58.  
  59.  
  60. 1. Introduction
  61. ===============
  62.  
  63.     triton.library is a standard Amiga shared, runtime library.  Triton
  64. makes it much easier to create good-looking graphical user interfaces (GUIs)
  65. than GadTools, BOOPSI or other systems.
  66.  
  67.     The most important features are:
  68.  
  69.     - Object oriented system
  70.     - Automatically font sensitive, font adaptive
  71.     - Automatic keyboard shortcuts for default window actions
  72.     - *Really* easy to use
  73.     - Beautiful OS2.x/3.x look
  74.     - Comes as a freely distributable shared library
  75.     - Size! Though Triton is very powerful, it is a shared library of less
  76.       than 40KB. You don't need any startup tools, editors, BOOPSI classes
  77.       or other things. It's the Triton among the minnows of GUI creation
  78.       systems ;)
  79.     - Resizeability of windows wherever applicable
  80.     - No large stack required
  81.  
  82.     By using Triton you don't have to worry about otherwise very
  83. time-consuming things like font-sensitivity and resizeability of your
  84. windows. What is even more important is that you can easily change your user
  85. interfaces later without having to rearrange display objects. Simply add an
  86. object to a group and the whole GUI will adapt to make room for it.
  87.  
  88.     The usage of a Triton GUI should be pretty clear.  All windows have
  89. two additional keyboard shortcuts (if not explicitly disabled by the
  90. application):  'Esc' will simulate the 'close window' gadget and 'Del' will
  91. simulate the 'resize window' gadget.  In palette, slider, scroller and
  92. similar gadgets with an up/down facility you can use the shifted shortcut to
  93. decrease the value.
  94.  
  95.  
  96. 2. Installation
  97. ===============
  98.  
  99.     First of all, Triton requires OS2.04 or higher. If you're still running
  100. 1.2 or 1.3, you have to upgrade to OS2.04 or better.
  101.  
  102.     To install triton.library copy it to your Libs: directory by hand, or
  103. run the installation script which corresponds to your system (OS2.0, OS2.1+
  104. with different languages) by double-clicking its icon.
  105.  
  106.  
  107. 3. Using triton.library
  108. =========================
  109.  
  110.     If you are a C programmer all you need to do is include the correct
  111. header ('libraries/triton.h') and open triton.library. After that you can
  112. use the functions in the library as if they were C functions. If your program
  113. quits it must of course close the library again. You may also use the support
  114. functions in the Triton linker library which make it even easier to use
  115. Triton. See 'demo.c' for an example.
  116.  
  117.     The FD (function description) file is included for the case that you
  118. want to write glue code for other compilers/languages. If you do so, please
  119. send it to me for inclusion in the next Triton distribution.
  120.  
  121.     Functions allowing a variable number of arguments can't be called using
  122. pragmas (in-line library calls; no glue code required). So if you use these
  123. you must always link with LIB:triton.lib (for SAS/C, or with the specific
  124. libraries for your compiler/language). All library functions are explained
  125. in the autodoc file 'triton.doc'.
  126.  
  127.                                                 Live long and prosper!
  128.  
  129.  
  130. 4. Astronomy Lesson
  131. ===================
  132.  
  133.                         Triton - A moon of Neptune
  134.  
  135.     Triton is a quaint little moon, in that it is one of the very few moons
  136. to be known to have retrograd orbits around their host. Triton is believed to
  137. be a 3-6000 km large world of mostly liquid nitrogen oceans, perhaps with a
  138. thin methane atmosphere as well, but noone knows for sure since either of the
  139. Voyager twins ever got close enough to take convincing snapshots.
  140.  
  141.     Neptune itself is also quite strange in that it has an almost 90 degree
  142. tilted inclination, so that it "rolls" through space, unlike Earth and the
  143. other planets (minus Venus), which all spin like tops in their orbits. Noone
  144. can tell for sure why Neptune has such an excentric inclination, but it has
  145. been suggested that it was caused by a gigantic collision of some sort
  146. (probably with a large asteroid). In the process Neptune also lost its third
  147. moon, which at the time was none other than Pluto. The collision accellerated
  148. Pluto to the point where it had enough momentum to actually leave its orbit
  149. and shoot into space on its own. As it did so it probably passed below the
  150. Roche' radius of Neptune, causing it to break up in two or more bodies under
  151. the influence of the massive tidal forces of Neptune. This would certainly
  152. account for Charon, which is in itself too large to have been "captured" by
  153. an object as small as Pluto.
  154.  
  155. Okay, end of today's astronomy lesson :-)
  156.  
  157.  
  158. 5. Library History
  159. ==================
  160.  
  161. *****************************************************************************
  162. RELEASE 1.0 (Library version 1.138)
  163.  
  164.     First release.
  165.  
  166.     Missing features, known bugs:
  167.     - No mutually exclusive menus
  168.     - TRAT_ID must be the *last* tag for all menu items
  169.     - No class authoring interface. This will follow soon. I will optimize
  170.       the class interface first.
  171.     - triton.library is a multiple-base library! That means you may not
  172.       use it from within single-base libraries and you cannot call
  173.       SetFunction() on functions of triton.library.
  174.     - triton.lib doesn't contain glue code for the library functions. You
  175.       have to create it yourself. I will add glue code in the next release.
  176.  
  177. *****************************************************************************
  178.  
  179.  
  180. 6. Credits
  181. ==========
  182.  
  183. Thanks must go to:
  184.  
  185.     - Nico François for his suggestions, beta-testing and helping me with
  186.       some very weird problems in Triton
  187.  
  188.     - Carsten Raufuß for beta-testing, suggestions and nagging ('When will
  189.       you finally implement listviews? I really need them for my GUI!' :-)
  190.  
  191.     - Kai Iske for his BOOPSI class sources
  192.  
  193.     - Michael Berg for the 'Astronomy Lesson' and beta-testing
  194.  
  195.     - All the unmentioned guys on SPOT.BETA for beta-testing and suggestions
  196.  
  197.     - Marco Frischkorn for beta-testing
  198.  
  199.     - Danny Schrod and Chris Reichert (SysOps of 'Plus' and 'Publishers
  200.       Treff') for support
  201.  
  202.     - SAS Institute for their great SAS/C compiler. With SAS/C it was
  203.       possible to develop Triton without a single line of assembly
  204.  
  205.     - Commodore for the Amiga
  206.  
  207.                   __
  208.                __///
  209.                \\\/...if(2B|!2B) user->prefs.shakespeare=TRUE;
  210.  
  211.  
  212. ============================= Archive contents =============================
  213.  
  214. Original  Packed Ratio    Date     Time    Name
  215. -------- ------- ----- --------- --------  -------------
  216.      628     271 56.8% 09-Apr-94 15:01:18  Triton.info
  217.       28      28  0.0% 09-Apr-94 15:01:18  Triton/Demo
  218.      495     343 30.7% 09-Apr-94 15:01:18  Triton/Demo.info
  219.      628     279 55.5% 09-Apr-94 15:01:18  Triton/Demos.info
  220.      628     260 58.5% 09-Apr-94 15:01:18  Triton/Demos/Demo.info
  221.    20916    8745 58.1% 09-Apr-94 15:01:26  Triton/Demos/Demo/Demo
  222.    37772    5433 85.6% 09-Apr-94 15:01:26  Triton/Demos/Demo/Demo.c
  223.      835     391 53.1% 09-Apr-94 15:01:20  Triton/Demos/Demo/Demo.info
  224.      432     267 38.1% 09-Apr-94 15:01:26  Triton/Demos/Demo/SMakefile
  225.      628     274 56.3% 09-Apr-94 15:01:20  Triton/Demos/EnvPrint.info
  226.     8992    4572 49.1% 09-Apr-94 15:01:26  Triton/Demos/EnvPrint/EnvPrint
  227.    10054    1891 81.1% 09-Apr-94 15:01:26  Triton/Demos/EnvPrint/EnvPrint.c
  228.      835     393 52.9% 09-Apr-94 15:01:20  Triton/Demos/EnvPrint/EnvPrint.info
  229.      452     270 40.2% 09-Apr-94 15:01:26  Triton/Demos/EnvPrint/SMakefile
  230.      326     144 55.8% 09-Apr-94 15:01:20  Triton/Demos/ReadMe
  231.      447     236 47.2% 09-Apr-94 15:01:20  Triton/Demos/ReadMe.info
  232.     3902    1578 59.5% 09-Apr-94 15:01:24  Triton/Distribution
  233.      447     235 47.4% 09-Apr-94 15:01:18  Triton/Distribution.info
  234.     1464     503 65.6% 09-Apr-94 15:01:18  Triton/Install.info
  235.     1065     470 55.8% 09-Apr-94 15:01:24  Triton/Install/Install Triton
  236.      474     277 41.5% 09-Apr-94 15:01:22  Triton/Install/ReadMe.Installer
  237.      437     232 46.9% 09-Apr-94 15:01:20  Triton/Install/ReadMe.Installer.info
  238.      563     316 43.8% 09-Apr-94 15:01:20  Triton/Install/Workbench_2.0.info
  239.      632     284 55.0% 09-Apr-94 15:01:20  Triton/Install/Workbench_2.1+.info
  240.      582     331 43.1% 09-Apr-94 15:01:20  Triton/Install/Workbench_2.1+/Dansk.info
  241.      584     335 42.6% 09-Apr-94 15:01:20  Triton/Install/Workbench_2.1+/Deutsch.info
  242.      584     331 43.3% 09-Apr-94 15:01:20  Triton/Install/Workbench_2.1+/English.info
  243.      584     336 42.4% 09-Apr-94 15:01:20  Triton/Install/Workbench_2.1+/Español.info
  244.      585     333 43.0% 09-Apr-94 15:01:22  Triton/Install/Workbench_2.1+/Français.info
  245.     7240    1523 78.9% 09-Apr-94 15:01:24  Triton/Install/Workbench_2.1+/Install Triton
  246.      585     337 42.3% 09-Apr-94 15:01:22  Triton/Install/Workbench_2.1+/Italiano.info
  247.      587     333 43.2% 09-Apr-94 15:01:22  Triton/Install/Workbench_2.1+/Nederlands.info
  248.      582     331 43.1% 09-Apr-94 15:01:20  Triton/Install/Workbench_2.1+/Norsk.info
  249.      586     335 42.8% 09-Apr-94 15:01:20  Triton/Install/Workbench_2.1+/Português.info
  250.      584     335 42.6% 09-Apr-94 15:01:20  Triton/Install/Workbench_2.1+/Svenska.info
  251.    35672   19249 46.0% 09-Apr-94 15:01:24  Triton/libs20/triton.library
  252.      628     273 56.5% 09-Apr-94 15:01:18  Triton/Programmer.info
  253.      628     276 56.0% 09-Apr-94 15:01:22  Triton/Programmer/Distribution.info
  254.      338     201 40.5% 09-Apr-94 15:01:24  Triton/Programmer/Distribution/ReadMe
  255.      447     235 47.4% 09-Apr-94 15:01:22  Triton/Programmer/Distribution/ReadMe.info
  256.      628     271 56.8% 09-Apr-94 15:01:22  Triton/Programmer/Distribution/Triton.info
  257.      643     360 44.0% 09-Apr-94 15:01:24  Triton/Programmer/Distribution/Triton/Install
  258.      557     315 43.4% 09-Apr-94 15:01:24  Triton/Programmer/Distribution/Triton/Install.info
  259.     2080     788 62.1% 09-Apr-94 15:01:24  Triton/Programmer/Distribution/Triton/ReadMe
  260.      447     235 47.4% 09-Apr-94 15:01:22  Triton/Programmer/Distribution/Triton/ReadMe.info
  261.    35672   19249 46.0% 09-Apr-94 15:01:24  Triton/Programmer/Distribution/Triton/triton.library
  262.      628     272 56.6% 09-Apr-94 15:01:22  Triton/Programmer/Doc.info
  263.    29832    8327 72.0% 09-Apr-94 15:01:24  Triton/Programmer/Doc/triton.doc
  264.      628     271 56.8% 09-Apr-94 15:01:22  Triton/Programmer/FD.info
  265.      624     300 51.9% 09-Apr-94 15:01:24  Triton/Programmer/FD/triton_lib.fd
  266.      628     271 56.8% 09-Apr-94 15:01:22  Triton/Programmer/Include.info
  267.     2945     626 78.7% 09-Apr-94 15:01:26  Triton/Programmer/Include/clib/triton_protos.h
  268.    39144    8202 79.0% 09-Apr-94 15:01:26  Triton/Programmer/Include/libraries/triton.h
  269.      847     248 70.7% 09-Apr-94 15:01:26  Triton/Programmer/Include/pragmas/triton_pragmas.h
  270.      180     123 31.6% 09-Apr-94 15:01:26  Triton/Programmer/Include/proto/triton.h
  271.      628     269 57.1% 09-Apr-94 15:01:22  Triton/Programmer/Lib.info
  272.      544     359 34.0% 09-Apr-94 15:01:24  Triton/Programmer/Lib/triton.lib
  273.      628     274 56.3% 09-Apr-94 15:01:22  Triton/Programmer/Source.info
  274.      275     186 32.3% 09-Apr-94 15:01:24  Triton/Programmer/Source/ReadMe
  275.      447     238 46.7% 09-Apr-94 15:01:24  Triton/Programmer/Source/ReadMe.info
  276.     2772     944 65.9% 09-Apr-94 15:01:26  Triton/Programmer/Source/triton_lib.c
  277.     7351    3317 54.8% 09-Apr-94 15:01:24  Triton/ReadMe
  278.      447     236 47.2% 09-Apr-94 15:01:18  Triton/ReadMe.info
  279. -------- ------- ----- --------- --------
  280.   272451   98467 63.8% 16-Apr-94 14:28:46   63 files
  281.